home *** CD-ROM | disk | FTP | other *** search
/ Gekikoh Dennoh Club 5 / Gekikoh Dennoh Club Vol. 5 (Japan).7z / Gekikoh Dennoh Club Vol. 5 (Japan) (Track 01).bin / internet / xip / bjpegb2.lzh / djpeg.txt < prev    next >
Text File  |  1997-09-19  |  8KB  |  206 lines
  1. DJPEG(1)                  User Commands                  DJPEG(1)
  2.  
  3. NAME
  4.      djpeg - decompress a JPEG file to an image file
  5.  
  6. SYNOPSIS
  7.      djpeg [ options ] [ filename ]
  8.  
  9. DESCRIPTION
  10.      djpeg decompresses the named  JPEG  file,  or  the  standard
  11.      input if no file is named, and produces an image file on the
  12.      standard output.  PBMPLUS (PPM/PGM), BMP, GIF, Targa, or RLE
  13.      (Utah  Raster  Toolkit) output format can be selected.  (RLE
  14.      is supported only if the URT library is available.)
  15.  
  16. OPTIONS
  17.      All switch names may be abbreviated; for example, -grayscale
  18.      may  be  written -gray or -gr.  Most of the "basic" switches
  19.      can be abbreviated to as little as one  letter.   Upper  and
  20.      lower  case  are equivalent (thus -GIF is the same as -gif).
  21.      British spellings are also  accepted  (e.g.,   - greyscale),
  22.      though for brevity these are not mentioned below.
  23.  
  24.      The basic switches are:
  25.  
  26.      -colors N
  27.           Reduce image to at most N  colors.   This  reduces  the
  28.           number  of  colors used in the output image, so that it
  29.           can be displayed on a colormapped display or stored  in
  30.           a colormapped file format.  For example, if you have an
  31.           8-bit display, you'd need to reduce  to  256  or  fewer
  32.           colors.
  33.  
  34.      -quantize N
  35.           Same as -colors.  -colors is the recommended  name,   -
  36.           quantize is provided only for backwards compatibility.
  37.  
  38.      -fast
  39.           Select recommended processing  options  for  fast,  low
  40.           quality  output.   (The  default options are chosen for
  41.           highest quality output.)  Currently, this is equivalent
  42.           to -dct fast -nosmooth -onepass -dither ordered.
  43.  
  44.      -grayscale
  45.           Force gray-scale output even if  JPEG  file  is  color.
  46.           Useful  for viewing on monochrome displays; also, djpeg
  47.           runs noticeably faster in this mode.
  48.  
  49.      -scale M/N
  50.           Scale the output image by a factor M/N.  Currently  the
  51.           scale factor must be 1/1, 1/2, 1/4, or 1/8.  Scaling is
  52.           handy if the image is larger than  your  screen;  also,
  53.           djpeg runs much faster when scaling down the output.
  54.  
  55.      -bmp  Select BMP  output  format  (Windows  flavor).   8-bit
  56.           colormapped  format is emitted if -colors or -grayscale
  57.           is specified, or if the JPEG file is gray-scale; other-
  58.           wise, 24-bit full-color format is emitted.
  59.  
  60.      -gif  Select GIF output format.  Since GIF does not  support
  61.           more  than  256  colors, -colors 256 is assumed (unless
  62.           you specify a smaller number of colors).
  63.  
  64.      -os2  Select BMP output format  (OS/2  1.x  flavor).   8-bit
  65.           colormapped  format is emitted if -colors or -grayscale
  66.           is specified, or if the JPEG file is gray-scale; other-
  67.           wise, 24-bit full-color format is emitted.
  68.  
  69.      -pnm  Select PBMPLUS (PPM/PGM) output format  (this  is  the
  70.           default  format).   PGM  is emitted if the JPEG file is
  71.           gray-scale or if -grayscale is specified; otherwise PPM
  72.           is emitted.
  73.  
  74.      -rle  Select RLE output format.  (Requires URT library.)
  75.  
  76.      -targa
  77.           Select Targa output format.  Gray-scale format is emit-
  78.           ted  if the JPEG file is gray-scale or if -grayscale is
  79.           specified; otherwise, colormapped format is emitted if
  80.           -colors is specified; otherwise, 24-bit full-color for-
  81.           mat is emitted.
  82.  
  83.      Switches for advanced users:
  84.  
  85.      -dct int
  86.           Use integer DCT method (default).
  87.  
  88.      -dct fast
  89.           Use fast integer DCT (less accurate).
  90.  
  91.      -dct float
  92.           Use floating-point DCT method.   The  float  method  is
  93.           very slightly more accurate than the int method, but is
  94.           much  slower  unless  your  machine   has   very   fast
  95.           floating-point hardware.  Also note that results of the
  96.           floating-point  method   may   vary   slightly   across
  97.           machines,  while  the  integer  methods should give the
  98.           same results everywhere.  The fast  integer  method  is
  99.           much less accurate than the other two.
  100.  
  101.      -dither fs
  102.           Use Floyd-Steinberg dithering in color quantization.
  103.  
  104.      -dither ordered
  105.           Use ordered dithering in color quantization.
  106.  
  107.      -dither none
  108.           Do  not  use  dithering  in  color  quantization.    By
  109.           default,  Floyd-Steinberg  dithering  is  applied  when
  110.           quantizing colors; this is slow  but  usually  produces
  111.           the  best  results.   Ordered  dither  is  a compromise
  112.           between speed and quality; no  dithering  is  fast  but
  113.           usually  looks awful.  Note that these switches have no
  114.           effect  unless  color  quantization  is   being   done.
  115.           Ordered dither is only available in -onepass mode.
  116.  
  117.      -map file
  118.           Quantize to the colors  used  in  the  specified  image
  119.           file.  This is useful for producing multiple files with
  120.           identical color maps, or for forcing a  predefined  set
  121.           of  colors  to  be used.  The file must be a GIF or PPM
  122.           file. This option overrides -colors and -onepass.
  123.  
  124.      -nosmooth
  125.           Use a faster, lower-quality upsampling routine.
  126.  
  127.      -onepass
  128.           Use one-pass instead of  two-pass  color  quantization.
  129.           The  one-pass  method  is faster and needs less memory,
  130.           but it produces a lower-quality image.    - onepass  is
  131.           ignored  unless you also say -colors N.  Also, the one-
  132.           pass method is always used for gray-scale  output  (the
  133.           two-pass method is no improvement then).
  134.  
  135.      -maxmemory N
  136.           Set limit for amount of memory  to  use  in  processing
  137.           large  images.  Value is in thousands of bytes, or mil-
  138.           lions of bytes if "M" is attached to the  number.   For
  139.           example,  -max 4m selects 4000000 bytes.  If more space
  140.           is needed, temporary files will be used.
  141.  
  142.      -outfile name
  143.           Send output image to the named file,  not  to  standard
  144.           output.
  145.  
  146.      -verbose
  147.           Enable debug printout.  More - v's  give  more  output.
  148.           Also, version information is printed at startup.
  149.  
  150.      -debug
  151.           Same as -verbose.
  152.  
  153. EXAMPLES
  154.      This example decompresses the JPEG file  foo.jpg,  automati-
  155.      cally  quantizes  to 256 colors, and saves the output in GIF
  156.      format in foo.gif:
  157.  
  158.           djpeg -gif foo.jpg > foo.gif
  159.  
  160. HINTS
  161.      To get a quick preview of an  image,  use  the   - grayscale
  162.      and/or   - scale  switches.    - grayscale -scale 1/8 is the
  163.      fastest case.
  164.  
  165.      Several options are available that trade off  image  quality
  166.      to gain speed.  -fast turns on the recommended settings.
  167.  
  168.      -dct fast and/or -nosmooth gain speed at a  small  sacrifice
  169.      in  quality.   When  producing  a  color-quantized  image, -
  170.      onepass -dither ordered is fast but much lower quality  than
  171.      the  default  behavior.    - dither none may give acceptable
  172.      results in two-pass mode, but is seldom  tolerable  in  one-
  173.      pass mode.
  174.  
  175.      If you are fortunate enough to have very fast floating point
  176.      hardware, -dct float may be even faster than -dct fast.  But
  177.      on most machines -dct float is slower than -dct int; in this
  178.      case it is not worth using, because its theoretical accuracy
  179.      advantage is too small to be significant in practice.
  180.  
  181. ENVIRONMENT
  182.      JPEGMEM
  183.           If this environment variable is set, its value  is  the
  184.           default  memory  limit.   The  value  is  specified  as
  185.           described for the -maxmemory switch.  JPEGMEM overrides
  186.           the  default  value specified when the program was com-
  187.           piled, and itself is overridden by an explicit   - max-
  188.           memory.
  189.  
  190. SEE ALSO
  191.      cjpeg(1), jpegtran(1), rdjpgcom(1), wrjpgcom(1)
  192.      ppm(5), pgm(5)
  193.      Wallace, Gregory K.  "The  JPEG  Still  Picture  Compression
  194.      Standard",  Communications  of the ACM, April 1991 (vol. 34,
  195.      no. 4), pp. 30-44.
  196.  
  197. AUTHOR
  198.      Independent JPEG Group
  199.  
  200. BUGS
  201.      Arithmetic coding is not supported for legal reasons.
  202.  
  203.      Still not as fast as we'd like.
  204.  
  205. JPEG                Last change: 15 June 1995                JPEG
  206.